home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 98 / Skunkware 98.iso / src / interp / perl5.005.tar.gz / perl5.005.tar / perl5.005 / README.dos < prev    next >
Text File  |  1998-06-10  |  7KB  |  277 lines
  1. If you read this file _as_is_, just ignore the funny characters you
  2. see. It is written in the POD format (see perlpod manpage) which is
  3. specially designed to be readable as is.
  4.  
  5. =head1 NAME
  6.  
  7. perldos - Perl under DOS, W31, W95.
  8.                                  
  9. =head1 SYNOPSIS
  10.  
  11. These are instructions for building Perl under DOS (or w??), using
  12. DJGPP v2.01 or later. Under w95 long filenames are supported.
  13.  
  14. =head1 DESCRIPTION
  15.  
  16. Before you start, you should glance through the README file
  17. found in the top-level directory where the Perl distribution
  18. was extracted.  Make sure you read and understand the terms under
  19. which this software is being distributed.
  20.  
  21. This port currently supports MakeMaker (the set of modules that
  22. is used to build extensions to perl).  Therefore, you should be
  23. able to build and install most extensions found in the CPAN sites.
  24.  
  25. =head2 Prerequisites
  26.  
  27. =over 4
  28.  
  29. =item DJGPP
  30.  
  31. DJGPP is a port of GNU C/C++ compiler and development tools to 32-bit,
  32. protected-mode environment on Intel 32-bit CPUs running MS-DOS and compatible
  33. operating systems, by DJ Delorie <dj@delorie.com> and friends.
  34.  
  35. For more details (FAQ), check out the home of DJGPP at:
  36.  
  37.         http://www.delorie.com/djgpp/
  38.  
  39. If you have questions about DJGPP, try posting to the DJGPP newsgroup:
  40. comp.os.msdos.djgpp, or use the email gateway djgpp@delorie.com.
  41.  
  42. You can find the full DJGPP distribution on any SimTel.Net mirror all over
  43. the world. Like:
  44.  
  45.         ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2*
  46.  
  47. You need the following files to build perl (or add new modules):
  48.  
  49.         v2/djdev201.zip
  50.         v2/bnu27b.zip
  51.         v2gnu/gcc2721b.zip
  52.         v2gnu/bsh1147b.zip
  53.         v2gnu/mak3761b.zip
  54.         v2gnu/fil316b.zip
  55.         v2gnu/sed118b.zip
  56.         v2gnu/txt122b.zip
  57.         v2gnu/dif271b.zip
  58.         v2gnu/grep21b.zip
  59.         v2gnu/shl112b.zip
  60.         v2gnu/gawk303b.zip
  61.         v2misc/csdpmi4b.zip 
  62.  
  63. or any newer version.
  64.  
  65. =item Pthreads
  66.  
  67. If you want multithreading support in perl, you need a pthread library
  68. that supports DJGPP. One of them can be found at:
  69.  
  70.         ftp://ftp.cs.fsu.edu/pub/PART/PTHREADS/pthreads.zip
  71.  
  72. But thread support is still in alpha, it may be unstable. For more information
  73. see below.
  74.  
  75. =back
  76.  
  77. =head2 Shortcomings of Perl under DOS
  78.  
  79. Perl under DOS lacks some features of perl under UNIX because of
  80. deficiencies in the UNIX-emulation, most notably:
  81.  
  82. =over 4
  83.  
  84. =item *
  85.  
  86. fork() and pipe()
  87.  
  88. =item *
  89.  
  90. some features of the UNIX filesystem regarding link count and file dates
  91.  
  92. =item *
  93.  
  94. in-place operation is a little bit broken with short filenames
  95.  
  96. =item *
  97.  
  98. sockets
  99.  
  100. =back
  101.  
  102. =head2 Building
  103.  
  104. =over 4
  105.  
  106. =item *
  107.  
  108. Unpack the source package F<perl5.00?_??.tar.gz> with djtarx. If you want
  109. to use long file names under w95, don't forget to use
  110.  
  111.         set LFN=y
  112.         
  113. before unpacking the archive.
  114.  
  115. =item *
  116.  
  117. Create a "symlink" or copy your bash.exe to sh.exe in your C<($DJDIR)/bin>
  118. directory.
  119.  
  120.         ln -s bash.exe sh.exe
  121.  
  122. And make the C<SHELL> environment variable point to this F<sh.exe>:
  123.  
  124.         set SHELL=c:/djgpp/bin/sh.exe (use full path name!)
  125.  
  126. You can do this in F<djgpp.env> too. Add this line BEFORE any section
  127. definition:
  128.  
  129.         +SHELL=%DJDIR%/bin/sh.exe
  130.  
  131. =item *
  132.  
  133. If you have F<split.exe> and F<gsplit.exe> in your path, then rename 
  134. F<split.exe> to F<djsplit.exe>, and F<gsplit.exe> to F<split.exe>.
  135. Copy or link F<gecho.exe> to F<echo.exe> if you don't have F<echo.exe>.
  136. Copy or link F<gawk.exe> to F<awk.exe> if you don't have F<awk.exe>.
  137.  
  138. =item *
  139.  
  140. Chdir to the djgpp subdirectory of perl toplevel and type the following
  141. command:
  142.  
  143.         configure.bat
  144.  
  145. This will do some preprocessing then run the Configure script for you.
  146. The Configure script is interactive, but in most cases you
  147. just need to press ENTER.
  148.  
  149. If the script says that your package is incomplete, and asks whether
  150. to continue, just answer with Y (this can only happen if you don't use
  151. long filenames).
  152.  
  153. When Configure asks about the extensions, I suggest IO and Fcntl,
  154. and if you want database handling then SDBM_File or GDBM_File
  155. (you need to install gdbm for this one). If you want to use the
  156. POSIX extension (this is the default), make sure that the stack
  157. size of your F<cc1.exe> is at least 512kbyte (you can check this
  158. with: C<stubedit cc1.exe>).
  159.  
  160. You can use the Configure script in non-interactive mode too.
  161. When I built my F<perl.exe>, I used something like this:
  162.  
  163.         configure.bat -Uuseposix -des
  164.  
  165. You can find more info about Configure's command line switches in
  166. the F<INSTALL> file.
  167.  
  168. When the script ends, and you want to change some values in the
  169. generated F<config.sh> file, then run
  170.  
  171.         sh Configure -S
  172.  
  173. after you made your modifications.
  174.  
  175. IMPORTANT: if you use this C<-S> switch, be sure to delete the CONFIG
  176. environment variable before running the script:
  177.  
  178.         set CONFIG=
  179.  
  180. =item *
  181.  
  182. Now you can compile Perl. Type:
  183.  
  184.         make
  185.  
  186. =back
  187.  
  188. =head2 Testing
  189.  
  190. Type:
  191.  
  192.         make test
  193.  
  194. You should see "All tests successful" if you configured a database
  195. manager, and 1 failed test script if not (F<lib/anydbm.t>). If you
  196. configured POSIX you will see 1 additional failed subtest in F<lib/posix.t>.
  197.  
  198. =head2 Installation
  199.  
  200. Type:
  201.  
  202.         make install
  203.  
  204. This will copy the newly compiled perl and libraries into your DJGPP
  205. directory structure. Perl.exe and the utilities go into C<($DJDIR)/bin>,
  206. and the library goes under C<($DJDIR)/lib/perl5>. The pod documentation
  207. goes under C<($DJDIR)/lib/perl5/pod>.
  208.  
  209. =head2 Threaded perl under dos-djgpp
  210.  
  211. Multithreading support is considered alpha, because some of the
  212. tests in C<ext/Thread> still die with SIGSEGV (patches are welcome). But
  213. if you want to give it a try, here are the necessary steps:
  214.  
  215. =over 4
  216.  
  217. =item
  218.  
  219. 1. You will need a pthread library which supports djgpp. Go, and download
  220. FSU's version from:
  221.  
  222.       ftp://ftp.cs.fsu.edu/pub/PART/PTHREADS/pthreads.zip
  223.  
  224. The latest version is 3.5, released in Feb 98.
  225.  
  226. =item 
  227.  
  228. 2. Unzip the file, cd to C<threads\src> and run F<configur.bat>.
  229.  
  230. =item 
  231.  
  232. 3. Add C<RAND_SWITCH> or C<MUTEX_SWITCH> or C<RR_SWITCH> to C<CFLAGS>
  233. in the F<makefile>. Note that using these values, multithreading will
  234. NOT be preemptive. This is necessary, since djgpp's libc is not thread safe.
  235.  
  236. =item 
  237.  
  238. 4. Apply the following patch:
  239.  
  240.     *** include/pthread/signal.h~    Wed Feb  4 10:51:24 1998
  241.     --- include/pthread/signal.h    Tue Feb 10 22:40:32 1998
  242.     ***************
  243.     *** 364,368 ****
  244.     --- 364,370 ----
  245.       
  246.       #ifndef SA_ONSTACK
  247.     + #ifdef  SV_ONSTACK
  248.       #define SA_ONSTACK SV_ONSTACK
  249.     + #endif
  250.       #endif /* !SA_ONSTACK */
  251.  
  252. =item
  253.  
  254. 5. run make (before you do this, you must make sure your C<SHELL> environment 
  255. variable does NOT point to bash).
  256.  
  257. =item
  258.  
  259. 6. Install the library and header files into your djgpp directory structure.
  260.  
  261. =item
  262.  
  263. 7. Add C<-Dusethreads> to the commmand line of perl's F<configure.bat>.
  264.  
  265. =back
  266.  
  267. =head1 AUTHOR
  268.  
  269. Laszlo Molnar, F<molnarl@cdata.tvnet.hu>
  270.  
  271. =head1 SEE ALSO
  272.  
  273. perl(1).
  274.  
  275. =cut
  276.  
  277.